Skip to content

Conversation

@mittler-works
Copy link
Contributor

@mittler-works mittler-works commented Jun 30, 2025

I am working on a train-the-trainers pathway called Jupyter-based teaching. In addition to the basics of Jupyter-based teaching and it's advantages, this pathway is intended to convey how Jupyter can be customized to the specific needs of your own course.

The tutorials are tailored to containerized Jupyter installations and present real-life use cases. Hands-On parts and their solutions are also presented in a containerized manner and can be reproduced on your own computer.

The tutorials for this pathway are including use cases like:

  • installing additional packages
  • installing additional kernels
  • configuring JupyterLab
  • configuring and installing proxy applications

An tutorial how you can use your customized JupyterLabs with Galaxy or JHaaS will be provided, too.

Please note, that this is Work in Progress! There is still missing text or just bullet points, there are no images yet and the examples have only been verified on linux so far.

Nevertheless, I'd like to create this PR as a draft to draw some attention to it. Even though the pathway and its tutorials aren't finished yet, I welcome feedback if anything seems to be unclear or missing. As long as this PR is WIP, any feedback can be included in the development.

Roadmap

Formalia
  • Formals added
  • Pathway file created
  • Tutorial files created
Contents
  • Pathway full text
  • Pathway final text
  • Tutorial Intro: bulletins
  • Tutorial Intro: full text
  • Tutorial Intro: final text
  • Tutorial basic customizations: bulletins
  • Tutorial basic customizations: full text
  • Tutorial basic customizations: final text
  • Tutorial basic customizations: hands on
  • Tutorial basic customizations: solution
  • Tutorial advanced customizations: bulletins
  • Tutorial advanced customizations: full text
  • Tutorial advanced customizations: final text
  • Tutorial advanced customizations: hands on
  • Tutorial advanced customizations: solution
  • Tutorial recommendations: bulletins
  • Tutorial recommendations: full text
  • Tutorial recommendations: final text
  • Tutorial recommendations: hands on
  • Tutorial recommendations: solution
  • Tutorial Galaxy: bulletins
  • Tutorial Galaxy: full text
  • Tutorial Galaxy: final text
  • Tutorial JHaaS: bulletins
  • Tutorial JHaaS: full text
  • Tutorial JHaaS: final text
Misc
  • Add images for easier understanding
  • Slides (?)

@mittler-works mittler-works force-pushed the jupyter-based-teaching branch from 716e856 to a611285 Compare July 3, 2025 08:45
@mittler-works mittler-works force-pushed the jupyter-based-teaching branch 2 times, most recently from 97d1f5c to 2710ec6 Compare October 28, 2025 14:17
@mittler-works mittler-works force-pushed the jupyter-based-teaching branch from 2710ec6 to 647f6a4 Compare October 28, 2025 14:20
Comment on lines +1 to +2
---
layout: tutorial_hands_on
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [GTN Lint] <GTN:046> reported by reviewdog 🐶
Please do not include an # Introduction section, it is unnecessary here, just start directly into your text. The first paragraph that is seen by our infrastructure will automatically be shown in a few places as an abstract.

Suggested change
---
layout: tutorial_hands_on
layout: tutorial_hands_on

Comment on lines +1 to +2
---
layout: tutorial_hands_on
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [GTN Lint] <GTN:046> reported by reviewdog 🐶
Please do not include an # Introduction section, it is unnecessary here, just start directly into your text. The first paragraph that is seen by our infrastructure will automatically be shown in a few places as an abstract.

Suggested change
---
layout: tutorial_hands_on
layout: tutorial_hands_on


Let's start this tutorial with a list of a few very common and important Jupyter terms.

### Jupyter
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [GTN Lint] <GTN:028> reported by reviewdog 🐶
You have skipped a heading level, please correct this.

Listing of Heading Levels
# Jupyter Terminology
### Jupyter
### Jupyter Notebook
### JupyterLab
### JupyterHub
# Advantages for teaching
# Disadvantages for teaching
# (WIP)
```suggestion ##r ```

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant